table of contents
XmStringCreateLtoR(library call) | XmStringCreateLtoR(library call) |
NAME¶
XmStringCreateLtoR — A compound string function that creates a compound string
SYNOPSIS¶
#include <Xm/Xm.h> XmString XmStringCreateLtoR( char *text, char *tag);
DESCRIPTION¶
This function is obsolete and exists for compatibility with previous releases. It is replaced by XmStringGenerate. XmStringCreateLtoR creates a compound string with two components: text and a tag component. This function scans for \n characters in the text. When one is found, the text up to that point is put into a segment followed by a separator component. No final separator component is appended to the end of the compound string. The direction component defaults to left-to-right. This function assumes that the encoding is single byte rather than multibyte.
The function will allocate space to hold the returned compound string. The application is responsible for managing the allocated space. The application can recover the allocated space by calling XmStringFree.
RETURN¶
Returns a new compound string.